.TH CRONTAB 1
.SH NAME
crontab \- manage crontab files
.SH SYNOPSIS
.B crontab
[\fB-u \fIuser\fR] [\fIfile\fR]
.br
.B crontab
[\fB-u \fIuser\fR] { \fB-l, -r -e\fR }
.SH DESCRIPTION
The
.B crontab
utility is used to update, delete, or display the
files that
.BR cron 8
uses to schedule jobs.  If invoked without options,
.B cron
copies the specified file, or the standard input
if no file is specified, into the directory that
holds all the system
.BR crontabs (5) .
.SS OPTIONS
.TP 10
.B -e
Edits a copy of the current user's crontab file, or creates an
empty file to edit if their crontab does not exist.  When editing
is complete, the file is installed as the user's crontab file.
.sp
The environment variables
.I \&$EDITOR
and
.I \&$VISUAL
determines which editor is used
.RI ( \&$EDITOR ,
then
.IR \&$VISUAL ,
and if neither of these is defined,
.BR vi )
.TP 10
.B -l
Lists the crontab file for the current user.
.TP 10
.B -r
Removes the crontab file for the current user.
.TP 10
.B \-u \fIuser\fR
If you are logged in as the superuser,  you can use 
.B -u
to specify a particular user's crontab to update,
delete, or list.
.SH BUGS
If you inadvertently enter the crontab command with no
arguments, you will lose your existing crontab unless
you exit with a
.B Control-C .
.B Crontab
attempts to catch this bug by refusing to overwrite a
crontab with an empty one, but it's better to be safe
than sorry.
.SH FILES
.TP 20
.B "/var/cron"
Where 
.BR cron (8)
looks for crontabs.
.SH SEE ALSO
.BR crontab (5) ,
.BR cron (8) .
.SH AUTHOR
David Parsons (orc@pell.portland.or.us)
